package com.cet6.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.cet6.entity.StudyRecord;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.util.List;
import java.util.Map;

@Mapper
public interface StudyRecordMapper extends BaseMapper<StudyRecord> {
    
    /**
     * 根据用户ID和单词ID查询学习记录
     * @param userId 用户ID
     * @param wordId 单词ID
     * @return 学习记录
     */
    StudyRecord selectByUserIdAndWordId(@Param("userId") Long userId, @Param("wordId") Long wordId);
    
    /**
     * 统计指定日期范围内的复习单词数
     * @param userId 用户ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 复习单词数
     */
    Integer countReviewWordsByDateRange(@Param("userId") Long userId, @Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);
    
    /**
     * 统计指定日期范围内的正确复习数
     * @param userId 用户ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 正确复习数
     */
    Integer countCorrectReviewsByDateRange(@Param("userId") Long userId, @Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);
    
    /**
     * 获取用户已学单词总数
     * @param userId 用户ID
     * @return 已学单词总数
     */
    Integer getTotalMasteredWords(@Param("userId") Long userId);
    
    /**
     * 获取用户学习总次数
     * @param userId 用户ID
     * @return 学习总次数
     */
    Integer getTotalStudyCount(@Param("userId") Long userId);
    
    /**
     * 获取用户复习单词数
     * @param userId 用户ID
     * @return 复习单词数
     */
    Integer getTotalReviewWords(@Param("userId") Long userId);
    
    /**
     * 获取用户学习天数
     * @param userId 用户ID
     * @return 学习天数
     */
    Integer getStudyDays(@Param("userId") Long userId);
    
    /**
     * 获取每日学习趋势数据
     * @param userId 用户ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 每日学习趋势数据
     */
    List<Map<String, Object>> getDailyStudyTrend(@Param("userId") Long userId, @Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);
}
